TEAM AA SFX BROWSER 1.2 — MAC FIRST BUILD
WHAT CHANGED IN 1.2
- Native CEP file drag from each sound row or its dotted handle.
- Default compact single-line rows, 27 CSS pixels high.
- Details button toggles two-line rows showing tags.
- Smaller player; on wide panels the search and header share a line.
- Visible v1.2 badge and versioned CSS/JS URLs to avoid stale UI resources.
- All saved folders, tags and favorites remain compatible.

DRAG AND DROP
Drag a filename or the dotted handle, not its Play or Favorite buttons.
In Premiere: drop on an audio track at the desired time; Adobe handles the
native drop, import and clip placement. A Project panel drop imports only.
The original file is dragged, never its temporary audio preview.
Dragging stops preview audio. A cancelled or rejected drag does not run the
panel's import/placement scripts. Drop behavior and target acceptance belong
to Adobe; the panel cannot confirm whether the drop was accepted.
The same payload is offered in AE; direct timeline acceptance needs testing
on your AE build. If rejected, use Add at playhead, or Import and then drag
from Adobe's Project panel. There is no simulated mouse/keyboard automation.
A native drop follows Adobe's normal editing behavior; the empty-track guard
applies only to the Add at playhead button, not native timeline drops.

COMPACT VIEW
Compact single-line rows are the default. Use Details to show tags per row.
You can search/filter tags even while their row details are hidden.
At narrow widths the toolbar wraps; the list keeps all remaining height.
If you still see the large old logo and no v1.2 badge, the previous panel is
loaded: quit both apps, rerun THIS folder's installer, then reopen the panel.
The installer backs up the existing per-user extension folder before copying.

WHAT CHANGED IN 1.1
- Tag, search and favorites filters start at the top of the results.
- Compact rows, smaller header, wrapped tags and a fixed bottom player.
- Folder manager opens as an overlay, with Close and Escape controls.
- Folder manager closes after adding a folder; it does not push the list down.
- Page controls appear only when there is more than one page.
- Existing folders, favorites and custom tags are preserved by this update.

UPGRADE: Quit both Adobe apps and run Install-Mac.command from this new folder.
No need to uninstall first. Existing panel files are backed up automatically.

Target: Premiere Pro 26.x and After Effects 26.x, macOS Intel / Apple silicon.

INSTALL
1. Extract this entire ZIP into a folder, such as Downloads.
2. Quit Premiere Pro and After Effects.
3. Run Install-Mac.command, read the message, and press Return.
4. Restart Adobe. Open Window > Extensions > Team AA SFX.
   Some builds label the menu Extensions (Legacy).
5. Open Folders > Add folder and select your SFX folder. Add more if needed.

If Finder cannot run the command file: open Terminal, type bash followed by
one space, drag Install-Mac.command into Terminal, then press Return.
The installer enables Adobe's per-user unsigned CEP panel preference for
CSXS 11 and 12. It does not disable macOS Gatekeeper and needs no sudo.
This is a source-folder package, not a signed/notarized .pkg installer.

USE
- Hover for 350 ms to hear a sound. Moving away stops it.
- If autoplay is blocked, click the small play button once.
- Turn off Hover preview for manual playback that continues while browsing.
- Click a row to select it. The bottom controls play, stop, adjust preview
  volume and seek by clicking the waveform.
- Search includes filenames, full folder paths and tags.
- Tags initially use filenames/folder names, not AI sound recognition.
- Edit tags overrides suggested tags for that sound. Separate tags with commas.
- The star on a row saves a favorite. The star next to search filters favorites.
- Import adds/reuses the original audio file in the project.
- Add at playhead in Premiere chooses the first completely empty, unlocked,
  unmuted audio track. Create an empty track with compatible audio channels if
  prompted. It never chooses an occupied track; placement does not ripple.
  Existing source In/Out marks on reused Premiere project items are respected.
- Add at playhead in AE creates a new audio layer in the active composition.
- Rescan with the refresh arrow after adding or moving files on disk.
- Both apps share folders, tags, favorites and preview preferences. Switching
  focus to a panel reloads shared settings. Files are not uploaded anywhere.

AUDIO FORMATS
WAV and MP3 are the best starting point. Also indexes AIF/AIFF, M4A, AAC,
FLAC and OGG. Actual decoding/import support depends on the codec and host.
If browser playback fails, the panel tries macOS afconvert to make a temporary
WAV preview. The original audio is still used for imports. Some codecs cannot
be previewed by either decoder; the panel reports this rather than silently
replacing the original. No FFmpeg, Python or separately installed Node needed.
Waveforms are generated on preview for decoded files up to 40 MiB.
Very large files can play without a waveform.

FILES AND SETTINGS
Your sound files stay where they are. Keep external drives connected.
Removing a folder in the panel does not remove any sound files.
Settings: ~/Library/Application Support/Team AA SFX/library.json
Preview cache: ~/Library/Application Support/Team AA SFX/preview-cache/
You may remove preview-cache with both panels closed to reclaim disk space.
Moving or renaming a sound changes its identity: reconnect its folder and tag
it again. Folder symlinks inside scanned folders are skipped to avoid loops.
An explicitly selected symlink root is resolved to its actual folder.
The browser uses pages of 100 rows to keep large lists manageable.

MANUAL INSTALL
Copy com.teamaa.sfx to:
~/Library/Application Support/Adobe/CEP/extensions/
In Terminal run:
defaults write com.adobe.CSXS.12 PlayerDebugMode -string 1
Then fully restart both Adobe applications.
For AE import errors mentioning scripting permissions, enable:
After Effects > Settings > Scripting & Expressions > Allow Scripts to Write
Files and Access Network. The panel itself does not use network services.

TROUBLESHOOTING
- Panel absent: check the exact folder path, that manifest.xml is in CSXS,
  the unsigned-panel setting, and that your app version is 26.x.
- Blank panel: send a screenshot and exact Adobe/macOS versions.
- Folder unavailable: reconnect its disk or grant the Adobe app folder access
  when macOS asks. Press Rescan.
- Library busy after an app crash: close both panels and remove the empty
  write.lock folder inside the Team AA SFX settings directory. Reopen.
- Uninstall-Mac.command moves the panel out of Adobe's extension directory.
  It preserves your settings and does not change other extensions.

VALIDATION AND LIMITATIONS
Source syntax, manifest, filter scroll regression, library persistence/scanning
drag payload/cancellation tests and mocked Adobe bridge
behavior are tested in the build environment. Neither Adobe desktop app nor
macOS is available there: real host loading, playback codecs, afconvert and
placement and native drag/drop need validation on your Mac. This is the first test build, not a
claim of certified compatibility with every Adobe 26 patch.

Development references:
https://github.com/Adobe-CEP/CEP-Resources
https://github.com/Adobe-CEP/Samples

Drag protocol reference: https://github.com/Adobe-CEP/Samples/blob/master/PProPanel/ext.js
